home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / scrbox.z / scrbox
Encoding:
Text File  |  2002-10-03  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ssssccccrrrrbbbbooooxxxx((((3333gggg))))                                                          ssssccccrrrrbbbbooooxxxx((((3333gggg))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ssssccccrrrrbbbbooooxxxx - control the screen box
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      subroutine scrbox(arg)
  13.      integer*4 arg
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _a_r_g   Expects one of the symbolic constants:
  17.  
  18.            SSSSBBBBRRRREEEESSSSEEEE:  initialize screen box limits and disable the updating of
  19.            screen box limits. (default)
  20.  
  21.            SSSSBBBBTTTTRRRRAAAACCCC:  track scan-converted geometry and characters and update
  22.            the scrbox limits accordingly.
  23.  
  24.            SSSSBBBBHHHHOOOOLLLLDDDD:  disable update of screen box limits; hold current values.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      ssssccccrrrrbbbbooooxxxx is a dual of the ssssccccrrrrmmmmaaaassss capability.  Rather than limiting drawing
  28.      effects to a screen-aligned subregion of the viewport, it tracks the
  29.      screen-aligned subregion (screen box) that has been affected.  Unlike
  30.      ssssccccrrrrmmmmaaaassss, which defaults to the viewport boundry if not explicitly enabled,
  31.      ssssccccrrrrbbbbooooxxxx must be explicitly turned on to be effective.
  32.  
  33.      While enabled (mode SSSSBBBBTTTTRRRRAAAACCCC) ssssccccrrrrbbbbooooxxxx maintains leftmost, rightmost, lowest,
  34.      and highest window coordinates of all pixels that are scan converted.
  35.      Because ssssccccrrrrbbbbooooxxxx operates on the pixels that result from the scan
  36.      conversion of points, lines, polygons, and characters; it correctly
  37.      handles wide lines, antialiased (smooth) points and lines, and
  38.      characters.  Because ssssccccrrrrbbbbooooxxxx operation may preceed the framebuffer, scan-
  39.      converted pixels may update the screen box regardless of their Z compare,
  40.      WID compare, or stencil compare results.
  41.  
  42.      ssssccccrrrrbbbbooooxxxx results are guaranteed to bound the modified framebuffer region,
  43.      but they may exceed the bounds of this region.
  44.  
  45.      ssssccccrrrrbbbbooooxxxx results are not affected by calls to cccclllleeeeaaaarrrr,,,, zzzzcccclllleeeeaaaarrrr,,,, sssscccclllleeeeaaaarrrr,,,, or
  46.      cccczzzzcccclllleeeeaaaa....
  47.  
  48.      When reset, the leftmost and lowest screen box values are set to be
  49.      greater than the rightmost and highest values, and the updating of screen
  50.      box limits is disabled.
  51.  
  52. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  53.      getscr, scrmas
  54.  
  55. NNNNOOOOTTTTEEEESSSS
  56.      IRIS-4D G, GT, and GTX models, Personal Iris, Impact, and Infinite
  57.      Reality, do not support ssssccccrrrrbbbbooooxxxx.  Use ggggeeeettttggggddddeeee to determine whether ssssccccrrrrbbbbooooxxxx
  58.      is supported.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.